home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / answers / comp / Solaris2 / FAQ < prev    next >
Internet Message Format  |  1994-04-13  |  67KB
  1. Path: bloom-beacon.mit.edu!hookup!swrinde!cs.utexas.edu!howland.reston.ans.net!EU.net!sun4nl!fwi.uva.nl!casper
  2. From: casper@fwi.uva.nl (Casper H.S. Dik)
  3. Newsgroups: comp.unix.solaris,comp.sys.sun.admin,comp.answers,news.answers
  4. Subject: Solaris 2 Frequently Asked Questions (FAQ) 1.37
  5. Supersedes: <Solaris2/FAQ_761592488@mail.fwi.uva.nl>
  6. Followup-To: comp.unix.solaris
  7. Date: 13 Apr 1994 16:05:33 GMT
  8. Organization: FWI, University of Amsterdam
  9. Lines: 1672
  10. Approved: news-answers-request@MIT.Edu
  11. Distribution: world
  12. Expires: 25 May 1994 16:05:32 GMT
  13. Message-ID: <Solaris2/FAQ_766253132@mail.fwi.uva.nl>
  14. Reply-To: casper@fwi.uva.nl
  15. NNTP-Posting-Host: adam.fwi.uva.nl
  16. Summary: This posting contains a list of Frequently Asked Questions (and 
  17.     answers) about Sun Microsystem's Solaris 2.x system in general.
  18.     See also the FAQs archived as Solaris2/Porting and Solaris2/x86.
  19. Xref: bloom-beacon.mit.edu comp.unix.solaris:15666 comp.sys.sun.admin:26105 comp.answers:4899 news.answers:18039
  20.  
  21. Archive-name: Solaris2/FAQ
  22. Version: 1.37
  23. Last-Modified: 1994/04/13 16:04:19
  24. Maintained-by: Casper Dik <casper@fwi.uva.nl>
  25.  
  26.  
  27. The following is a list of questions that are frequently asked about
  28. Solaris 2.x.  You can help make it an even better-quality FAQ by writing a
  29. short contribution or update and sending it BY EMAIL ONLY to me.
  30. Thanks!
  31.  
  32. I've added an index of questions and marked changed(*) and added
  33. questions(+).  The FAQ is being reorganised, time permitting.
  34. The index is generated automatically, so there may be errors there.
  35. Not all questions are in the section they belong in. Suggestions on
  36. how best to subdivide/order the FAQ are welcome.
  37.  
  38.  
  39.   1. GENERAL
  40.     1.1) What's a Solaris anyway?
  41.     1.2) Why should I care? Why should I upgrade?
  42.     1.3) Should I move to Solaris 2.x now, or later, or never?
  43.     1.4) What is Solaris 2? Is it really SVR4 based?
  44.    *1.5) What machines does Solaris 2.x run on?
  45.     1.6) Will my XXX applications from 4.1.x run on Solaris 2?
  46.     1.7) Will my XXX applications from SVR3 on the 386 run on Solaris 2/Intel?
  47.     1.8) Where has the XXX command gone now?
  48.     1.9) When I upgrade, should I use SunInstall "upgrade", or start over?
  49.    *1.10) Is Solaris 2.x reliable/stable enough to use?
  50.    *1.11) Why do some people dislike Solaris2?
  51.     1.12) Do some people *like* Solaris2?
  52.   2. MORE INFO
  53.    *2.1) How can I RTFM when I don't have it anymore?
  54.     2.2) Why is "man -k" so confused? 
  55.     2.3) What Software is available for Solaris 2.x?
  56.     2.4) What FTP sites do I need to know about?
  57.     2.5) What other FAQ's do I need to know about?
  58.     2.6) What mailing lists should I get?
  59.     2.7) What books should I read?
  60.   3. SYSTEM ADMINISTRATION
  61.     3.1) How much disk space do I need to install Solaris 2?
  62.     3.2) How can I convert all my local changes that I've made over the years
  63.     3.3) What are "packages"?
  64.     3.4) Why can't I write in /home?
  65.     3.5) Why can't I access CDs or floppies?
  66.     3.6) What is this junk mail about an error in the crontab entry?
  67.     3.7) Why are there no passwords in /etc/passwd?
  68.     3.8) Why can't I rlogin/telnet in as root?
  69.     3.9) How can I set up anonymous FTP?
  70.     3.10) How can I print from a Solaris 2 (or any System V Release 4) system to
  71.     3.11) What if I'd rather use the old familiar BSD-style line printer system?
  72.     3.12) What happened to /dev/MAKEDEV? How do I add devices?
  73.     3.13) What happened to /etc/rc and /etc/rc.local?
  74.     3.14) Speaking of that, why are there two versions of shutdown?
  75.     3.15) When will somebody publish a package of the BSD (4.3BSD Net2) "init",
  76.     3.16) What has happened to getty? What is pmadm and how do you use it?
  77.     3.17) How do I get the screen to blank when nobody's using it?
  78.     3.18) And what about screendump, screenload and clear_colormap?
  79.     3.19) Where did etherfind go?
  80.     3.20) Can I run SunOS4.1.x on my SPARC Classic or LX?
  81.     3.21) The "find" program complains that my root directory doesn't exist?
  82.     3.22) I'm having troubles with high-speed input on the Sparc serial ports.
  83.     3.23) How do I make ksh or csh be the login shell for root?
  84.     3.24) What is this message: "automount: No network locking on thathost,
  85.     3.25) How do I make Solaris2 use my Toshiba MK538FB drives?
  86.    *3.26) How do I make Solaris2 use my old ADAPTEC ACB-4000 and Emulex MD-21 disks?
  87.    *3.27) Why are there so many patches for Solaris 2.3? It's only been out a month!
  88.    +3.28) What are the ``mandatory'' patches I keep hearing about?
  89.     3.29) Where do I get patches from?
  90.     3.30) Why does installing patches take so much space in /var/sadm?
  91.     3.31) Do I need to back out previous versions of a patch?
  92.    +3.32) How can I have more than 48 pseudo-ttys?
  93.    +3.33) I messed up /etc/system, now I can't boot.
  94.   4. NETWORKING
  95.    *4.1) Can I use DNS with Solaris 2.x?
  96.     4.2) How do I use DNS w/o using NIS or NIS+?
  97.    *4.3) Speaking of nsswitch.conf, what is it?
  98.     4.4) So what does [NOTFOUND=return] in nsswitch.conf mean, and where does it go?
  99.    +4.5) Can I run a nis/yp server under Solaris 2.x?
  100.    +4.6) Can I run NIS+ under Solaris 1 (SunOS 4.1.x)
  101.    +4.7) With NIS+ how do I find out which machine a client is bound to?
  102.    +4.8) Ypcat doesn't work on the netgroup table on a NIS+ server, why?
  103.    +4.9) Why is rpc.nisd such a memory pig according to ps?
  104.   5. TROUBLE SHOOTING
  105.     5.1) Why can't I run Answerbook on a standalone machine?
  106.     5.2) Why can't I run filemgr, I get ``mknod: permission denied''?
  107.    *5.3) Why do I get isinf undefined when linking with libdps?
  108.    +5.4) I can't get PPP to work between Solaris 2.3 and other platforms.
  109.    +5.5) Using compat mode for passwd doesn't work in 2.3?
  110.    +5.6) Why do I get __builtin_va_alist or __builtin_va_arg_incr undefined?
  111.    +5.7) My machine hangs during the boot process.  It seems related to ps.
  112.   6. SOFTWARE DEVELOPMENT
  113.     6.1) Where is the C compiler or where can I get one?
  114.     6.2) What about the linker, the assembler and make?
  115.     6.3) What do I need to compile X11R5?
  116.     6.4) What happened to NIT? What new mechanisms exist for low-level network access?  
  117.     6.5) Where are all the functions gone that used to be in libc?
  118.     6.6) I'm still missing some functions: bcopy, bzero and friends.
  119.     6.7) Can I use the source compatibility package to postpone porting?
  120.     6.8) Why doesn't readdir work?
  121.   7. ACKNOWLEDGEMENTS
  122.  
  123. 1. GENERAL
  124.  
  125. 1.1) What's a Solaris anyway?
  126.  
  127.     Solaris(tm) is Sun's name for their UNIX-based user environment,
  128.     including the UNIX(tm) operating system, window system (X11-based),
  129.     and other stuff too.
  130.  
  131.     Solaris 1.x is a retroactive (marketing?) name for SunOS4.1.x (x>=1),
  132.         a version of UNIX that is BSD-like with some SVR4 features,
  133.         along with OpenWindows 3.0.
  134.     Solaris 2.x (which is what most everybody means by "Solaris")
  135.         includes SunOS5.x, which is an SVR4-derived UNIX,
  136.         along with OpenWindows 3.x, tooltalk, and other stuff.
  137.     For more details, see the chart in the next-to-next question.
  138.  
  139. 1.2) Why should I care? Why should I upgrade?
  140.  
  141.     Solaris 2 is more compatible with the rest of the UNIX industry.
  142.     Other major UNIX vendors including IBM, HP, SGI, SCO, and others
  143.     are based on System V rather than on BSD (though some of them
  144.     are on SVR3, not SVR4). All but one commercial PC-based UNIXes 
  145.     are System V based (and mostly SVR4); the only commercial exception
  146.     is from a small but interesting firm called BSDI.
  147.  
  148.     Solaris 2 is where Sun has been putting almost all its development
  149.     for the last few years now. There will be no new development on
  150.     SunOS4; already many of Sun's add-on software is only available
  151.     for Solaris 2. Solaris 2 is the only MP-capable SunOS on the SS10.
  152.  
  153.     Solaris 2 is required to run Wabi, Sun's exciting new
  154.     MS-Windows emulator.
  155.  
  156.     Solaris 2.3 features a standard X11R5 release of The X Window
  157.     System, a benefit for those who didn't like NeWS or the 
  158.     V2/V3 OpenWindows server. (It's still called OpenWindows, but
  159.     it is the X11R5 server with Adobe DPS added in).
  160.  
  161.     Solaris 2 is more standards-compliant than Solaris 1/SunOS 4.
  162.  
  163. 1.3) Should I move to Solaris 2.x now, or later, or never?
  164.  
  165.     That depends - on you, your situation, your application mix, etc.
  166.     Some year SunOS4.1.x will go the way of the 3/50 - it'll still
  167.     be around, but Sun will no longer support it.
  168.  
  169.     You don't have to upgrade immediately, but you should be
  170.     planning your upgrade path by now.
  171.  
  172. 1.4) What is Solaris 2? Is it really SVR4 based?
  173.  
  174.     Solaris 2 is an "operating environment" that includes the
  175.     SunOS 5.x operating system and the OpenWindows 3.x window
  176.     environment.
  177.  
  178.     SunOS 5.x are based on USL's SVR4.0. SVR4.0, in turn, was
  179.     developed jointly by AT&T and Sun while Sun was developing 4.1.0,
  180.     which is why things like RFS, STREAMS, shared memory, etc.,
  181.     are in SunOS 4.1.x, and why things like vnodes, NFS and XView
  182.     are in SVR4.0. (RFS, by the way, is being dropped effective
  183.     with Solaris 2.3).
  184.  
  185. 1.5) What machines does Solaris 2.x run on?
  186.  
  187.     Solaris 2.0 only ran on desktop SPARCstations and a few other Sun
  188.     machines.
  189.  
  190.     Solaris 2.1 and later comes in two flavors, SPARC and "x86".
  191.  
  192.     Solaris 2.1 (and 2.2, ...) for SPARC run on all SPARCstations and
  193.     clones, as well as all models of the Sun-4 family. The old FPU
  194.     on the 4/110 and 260/280 is not supported, so floating point
  195.     will be SLOW, but it does work.
  196.  
  197.     A Solaris port for the PowerPC is underway.  It is not
  198.     expected to be completed this year.  It is also unknown
  199.     at this time what PowerPC hardware will be supported.
  200.  
  201.     Solaris 2.1 for x86 has been released to end users.
  202.     It runs on a wide range of high-end PC-architecture machines.
  203.     "High-end" means: 16MB of RAM and an 80486 (or 33MHz or faster
  204.     80386DX).  It will not run on your 4 MB 16MHz 386SX, so don't
  205.     bother trying! Also, floating point hardware (80387-style) is
  206.     absolutely required in 2.1.  Starting with Solaris 2.4 for
  207.     x86, a fp Coprocessor is no-longer required, though still
  208.     recommended.  All three buses are supported: ISA, EISA, MCA.
  209.  
  210.     To summarize all this, Jim Prescott gave this chart, which I've updated:
  211.     Solaris    SunOS      OpenWin        Comments
  212.     1.0    4.1.1B      2.0
  213.         4.1.1_U1  2.0        sun3 EOL release (not named Solaris)
  214.     1.0.1    4.1.2      2.0        (6[379]0-1[24]0 MP)
  215.     1.1    4.1.3      3.0        SP Viking support
  216.     1.1C    4.1.3C      3.0?        Downgrade Classic or LX from S2 to S1.
  217.     1.1.1    4.1.3_U1  3.0?        4.1.3 + fixes + Classic/LX support
  218.     2.0    5.0      3.0.1        sun4c only
  219.        2.1SPARC    5.1      3.1         Dec '92
  220.        2.1 x86    5.1      3.1         May '93
  221.        2.2SPARC    5.2      3.2        May '93
  222.        2.3SPARC    5.3      3.3        Nov '93
  223.                 OpenWin 3.3 (previously called OpenWin 4.0,
  224.                 recently renamed so as to track the OS minor
  225.                 release number) is X11R5 based: Display
  226.                 PostScript instead of NeWS, no SunView.
  227.                 It is still primarily OPEN LOOK.
  228.                 The Spring 1994 OpenWin will be Motif
  229.                 and COSE-based.
  230.     2.3 edition II SPARC    Special Solaris 2.3 distribution for
  231.                 Voyager and SparcStation 5
  232.     2.4    SPARC/x86    Formerly known as 2.4, then known as 2.3.2,
  233.                 now again called 2.4.
  234.                 From this moment on, the SPARC and x86
  235.                 releases will be in sync. Q3 '94
  236.  
  237. 1.6) Will my XXX applications from 4.1.x run on Solaris 2?
  238.  
  239.     There is quite a bit of support in SunOS 5.x for running 4.1.x
  240.     binaries in an emulation mode called "Binary Compatibility"
  241.     (BCP).  This works by dynamically linking the 4.1.x binaries
  242.     with a shared library that emulates the 4.1.x binary interface
  243.     on top of 5.x, so there is some overhead. Programs will only
  244.     work if they were dynamically linked (statically linked
  245.     binaries run in 2.3, but with some extra restrictions),
  246.     and if they meet certain other criteria. Best bet:
  247.     try it and see.
  248.  
  249.     Be aware, though, that Sun WILL drop the binary compatibility 
  250.     package some year.  Try to wean yourself and your users from
  251.     depending on it, even if it means beating on your software
  252.     vendors to offer "native" Solaris2 applications.
  253.  
  254. 1.7) Will my XXX applications from SVR3 on the 386 run on Solaris 2/Intel?
  255.  
  256.     As with SPARC, there is an emulation mode that should run the
  257.     majority of well-behaved SVR3 and Xenix binaries. I've not
  258.     had time to test it.
  259.  
  260.     Applications from any other vendor's standards-conforming 
  261.     386/486 SVR4 should also run.
  262.  
  263.     However, some vendors have made incompatible changes to their
  264.     SVR4 release and programs linked on those versions may not work.
  265.  
  266. 1.8) Where has the XXX command gone now?
  267.  
  268.     There are too many of these changes to include in this FAQ, but
  269.     here are some key ones:
  270.  
  271.         a. locations are often different
  272.                  hostid         /usr/ucb/hostid
  273.                  whoami         /usr/ucb/whoami
  274.                  hostname       /usr/ucb/hostname (or use uname -n)
  275.  
  276.         b. some old commands don't exist or have replacements
  277.  
  278.                  4.1.X          Solaris 2.X
  279.  
  280.                  pstat -s       swap -s  (how much swap space?)
  281.                  dkinfo         /usr/sbin/prtvtoc raw_dev_name
  282.                  trace          truss
  283.                  mount -a       mountall
  284.                  exportfs       share
  285.                  bar            cpio -H bar (read only)
  286.  
  287.     This information can be found in the Solaris 2.x Transition Guide - 
  288.     Appendix A (commands), Appendix B (system calls), Appendix C (files).
  289.  
  290.     This guide has undergone some changes from 2.0 -> 2.1 and beyond.
  291.     Several manuals have ended up being combined into this single
  292.     manual. This manual discusses adminstrative transition and
  293.     developer transition issues.
  294.  
  295.     The command "whatnow" (for Solaris 2.x) is included in the
  296.     "Admigration Toolkit" package (see below). The Admigration
  297.     toolkit can be obtained from:
  298.  
  299.         opcom.sun.ca:/pub/AMToolkit-2.2a.*
  300.     
  301.     Sample output:
  302.         % whatnow hostname
  303.         hostname                                        4.x command only 
  304.         hostname        /usr/ucb/hostname               part of SCP package
  305.         hostname        /usr/bin/uname -n               alternate command
  306.  
  307.     The whatnow command is limited in that it may point to
  308.     one command which may only implement a subset of the old
  309.     command (e.g., pstat points to sar, while pstat -s is identical
  310.     to swap -s)
  311.  
  312. 1.9) When I upgrade, should I use SunInstall "upgrade", or start over?
  313.  
  314.     You can't do a SunInstall "upgrade" from 4.1.x to Solaris2.
  315.     You can use the Admigration toolkit (q.v.) to help you move
  316.     from SunOS 4.1.x (Solaris 1, actually) to Solaris 2.
  317.  
  318.     If you're moving from Solaris 2.1 to 2.2, or 2.2 to 2.3, ...,
  319.     then you can use "upgrade" to preserve your existing partitions
  320.     and local changes (including pkgadd!!), though it runs very
  321.     slowly (about 1.5-2x the time for a reinstall) and does require
  322.     that you have enough free space in / and /usr - make these big
  323.     when you first install!  If you run out of space in one of
  324.     your partitions, you can always remove some components.  Those
  325.     will not be upgraded and can be installed elsewhere after
  326.     initial upgrade (e.g., you can remove OW, Xil, Dxlib, manual
  327.     pages, etc)
  328.  
  329.     There is no need to backout patches before upgrading.
  330.     In 2.2, the system would back them out for you, in 2.3 it
  331.     won't back out the patches but removes them without a trace.
  332.  
  333.     The upgrade doesn't work as well as a full install.
  334.     E.g., the upgrade from 2.x (x<3) to 2.3 will leave
  335.     aliases for all your ptys in /devices/pseudo.
  336.  
  337. 1.10) Is Solaris 2.x reliable/stable enough to use?
  338.  
  339.     The consensus seems to be that yes, it is, for many applications
  340.     and most users. Your mileage may vary.
  341.  
  342.     Binary compatibility was much improved in 2.3.  That will help
  343.     transition somewhat.  The performance of 2.3 is adequate, though
  344.     some parts of the system are still slower than SunOS 4.1.x.
  345.     Solaris 2.3 is much more stable on MP machines than 2.2.
  346.     The Solaris 2.3 version of OpenWindows is much faster and much
  347.     more stable than the versions shipped with SunOS 4.1.x.
  348.  
  349.     Solaris 2.1 and earlier should really be avoided.  Solaris 2.2
  350.     should be avoided too, but some people need to stick to it
  351.     until some applications get ported (2.2 is the last release
  352.     with NeWS)
  353.  
  354.     Solaris 2.3 still has some problems on high-end MP systems with
  355.     large numbers of interactive users.  Solaris 2.4 promises much
  356.     more scalable multi-processing.
  357.  
  358. 1.11) Why do some people dislike Solaris2?
  359.  
  360.     There is a number of reasons why people dislike Solaris.
  361.  
  362.     1) Change.  In general people dislike change.  Change requires
  363.     relearning and retraining.  Old system administration practices
  364.     no longer work.  Commands have been replaced by other commands,
  365.     some commands behave differently.  And they ask why the change was
  366.     necessary.  SunOS 4.x worked for them.
  367.  
  368.     2) Lack of migration support.  Sun did not provide a lot of
  369.     tools to ease migration.  Many applications wouldn't run in the
  370.     binary compatibility mode.  The source compatibility mode was
  371.     probably compatible with some OS, but it certainly wasn't SunOS.
  372.     Lot of public domain and third party stuff needed wasn't
  373.     immediately available for Solaris.  NIS+, buggy, resource hungry
  374.     and instable replaced NIS in incompatible ways.
  375.  
  376.     3) Missing functionality.  When people migrate, they at first
  377.     don't tend to notice new functionality.  Instead, they stumble
  378.     upon missing functionality such as screenblank, clear_colormap
  379.     and the like.
  380.  
  381.     4) Slow and buggy.  The initial Solaris releases didn't perform
  382.     at all well and were extremely instable.  This is improving
  383.     rapidly, but SuperSPARC MP machines need a heavily patched 2.3
  384.     to work reliably.
  385.  
  386. 1.12) Do some people *like* Solaris2?
  387.  
  388.     Yes!  There are improvements in Solaris 2.x.
  389.  
  390.     1) OpenWindows 3.3 (in Solaris 2.3).  Includes X11R5 and
  391.     Display PostScript.
  392.  
  393.     2) ANSI-C and POSIX development environment.
  394.  
  395.     3) Multithreaded kernel and real threads.
  396.  
  397.     4) True multi-processing.
  398.  
  399.     5) Goodies: vold, admintool and Wabi.
  400.  
  401. 2. MORE INFO
  402.  
  403. 2.1) How can I RTFM when I don't have it anymore?
  404.  
  405.     "RTFM" is an old saying: Read The "Fine" Manual.  Sun still
  406.     sell printed manuals, but doesn't automatically distribute
  407.     them.  As with all real UNIX systems, you do get a full set of
  408.     online "man" pages. A smaller, lighter, bookshelf-friendly :-)
  409.     CD-ROM called "The AnswerBook"(tm) contains all the printed
  410.     documents in machine-readable (PostScript) form, with hypertext
  411.     capabilities and a keyword search engine. 90% of your
  412.     introductory questions are answered therein!
  413.  
  414.     In Solaris 2.x the Answerbook set gets increasingly more
  415.     divided into pieces.  It is currently (2.3) split over 4 CDs
  416.  
  417.         Solaris 2.x CD:
  418.         Solaris 2.x User AnswerBook
  419.  
  420.         Solaris 2.x administrator answerbook
  421.         Solaris 2.x System Administrator AnswerBook
  422.         Solaris 2.x on Sun Hardware AnswerBook
  423.         Solaris 2.x Reference Manual AnswerBook
  424.  
  425.         Solaris 2.x Software Developer Kit
  426.         All programming manuals.
  427.  
  428.         Solaris 2.x Driver Developer Kit
  429.         Device driver developer manuals.
  430.  
  431.     There is some overlap between CDs.
  432.  
  433.     As distributed with 2.1 and 2.2, the Answerbook search engine
  434.     runs only with the OpenWindows ("xnews") server, not with MIT
  435.     X11. This changed in 2.3. If you are using the MIT server
  436.     instead of what Sun provides, you'll have to use one of several
  437.     "answerbook workaround" scripts that are in circulation. The
  438.     AnswerBook distributed with 2.3 and later runs with the OW3.3
  439.     X11R5+DPS server, so it should display on any X11+DPS server,
  440.     such as on DEC, IBM and SGI workstations.
  441.  
  442.     You should buy (or print from within Answerbook) at least the
  443.     reference manual and the System and Network Administration
  444.     books, because if your system becomes disabled you won't be
  445.     able to run the Answerbook to find out how to fix it...
  446.  
  447. 2.2) Why is "man -k" so confused? 
  448.  
  449.       Solaris man uses a manual page index file called "windex" in
  450.       place of the old "whatis" file. You can build this index with
  451.         cd <man-page-directory>; catman -w -M .
  452.  
  453.       But, in 2.1, this will result in numerous "line too long" messages 
  454.       and a bogus windex file in /usr/share/man, and a core dump in
  455.       /usr/openwin/man. (In 2.2, catman works in /usr/share/man, but
  456.       says "line too long" in /usr/openwin/man).  To add injury to
  457.       insult, "man" normally won't show you a man page if it can't find
  458.       the windex entry, even though the man page exists.
  459.  
  460.       There's a "makewhatis" script in /usr/openwin/man that works
  461.       better than catman. But watch it - by default it searches files
  462.       in /usr/man, not in openwin, and it only looks in some predefined
  463.       man subdirectories. Try changing its "for ..." command to 
  464.       "for i in man*", then use it like this:
  465.         cd /usr/share/man; /usr/openwin/man/makewhatis .
  466.         cd /usr/openwin/man; /usr/openwin/man/makewhatis .
  467.  
  468.       Still (!), the openwin windex file is somewhat hosed (try "man
  469.       answerbook" :-(.  You can always delete the bogus lines manually...
  470.       or, you can alias man to "man -F", forcing it to look for the
  471.       bloody file like you asked.
  472.  
  473.       But wait, there's more! To see the read(2) man page, you can't
  474.       just type "man 2 read" anymore - it has to be "man -s 2 read".
  475.       Or, alias man to this little script:
  476.  
  477.         #!/bin/sh
  478.         if [ $# -gt 1 -a "$1" -gt "0" ]; then
  479.             /bin/man -F -s $*
  480.         else
  481.             /bin/man -F $*
  482.         fi
  483.  
  484. 2.3) What Software is available for Solaris 2.x?
  485.  
  486.     Most commercial software that ran on 4.x either will run in BCP
  487.     mode, or is available for Solaris 2.x, or is being ported now.
  488.     Solaris 2.3 BCP mode finally supports statically-linked executables.
  489.  
  490.     You can obtain a list of official 3rd party porting
  491.     commitments, maintained by Sun's "Solaris Demand Center"
  492.     (whatever that is), by sending electronic mail to
  493.     "solaris2apps@sun.com" -- this is an automatic reply server.  The list
  494.     shows what third party applications are currently available for 
  495.     Solaris, and lists expected dates for many more.
  496.  
  497.     A list of freeware (some "public domain", but mostly copyright-
  498.     but-freely-distributable) [as well as commercial software??]
  499.     that has been ported to Solaris 2.x
  500.     is posted monthly to the newsgroup comp.unix.solaris by
  501.     ric@updike.sri.com (Richard Steinberger). Look for this:
  502.  
  503.         Subject: Solaris SW list.  Monthly Post.
  504.  
  505.     If you can't wait, the list is also available via anonymous FTP
  506.     from updike.sri.com.
  507.  
  508. 2.4) What FTP sites do I need to know about?
  509.  
  510.     SunSite (sunsite.unc.edu) - Sun sponsors an FTP site at the
  511.     University of North Carolina. Lots of good stuff here.
  512.  
  513.     ftp.x.org (or export.lcs.mit.edu) - the master X11 site
  514.  
  515.     ftp.uu.net    - UuNet communication archives
  516.  
  517.     OpCom. (opcom.sun.ca) - run by Sun Microsystems' OpCom group - lots 
  518.     of stuff. Here is some of the stuff that's online:
  519.  
  520.     pub/AMToolkit.*    - the Administration Migration (4.1.x to Solaris 2)
  521.               Toolkit
  522.  
  523.     pub/binaries    - binaries/man pages for Solaris 2.0 native binaries.
  524.  
  525.     pub/newsletter  - issues of the monthly OpCom newsletter.
  526.  
  527.     pub/docs        - assorted documentation, papers, and other information.
  528.             - all of the RFCs
  529.  
  530.     pub/drivers     - information related to device driver writing under
  531.               under Solaris 2.0 as well as a skeleton SCSI driver.
  532.  
  533.     ls-lR.Z         - compressed recursive listing of files available
  534.               on the server.
  535.  
  536.     pub/tars        - compressed tars.
  537.  
  538.     pub/tmp         - place for uploading things to the server.
  539.  
  540.     pub/R5          - the unadultered MIT x11r5 distribution.
  541.  
  542.     pub/x11r5       - port of X11r5 to Solaris 2.0, binaries, libraries
  543.               and headers.  A compressed tar of this tree can
  544.               be found in tars.
  545.  
  546.     prep.ai.mit.edu and the GNU mirrors
  547.  
  548.     pub/gnu/sparc-sun-solaris2    - recent gcc binaries for SPARC
  549.     pub/gnu/i486-sun-solaris2    - recent gcc binaries for i486
  550.  
  551. 2.5) What other FAQ's do I need to know about?
  552.  
  553.     All of them :-). But in particular you should see these FAQ's:
  554.     
  555.     1) Newsgroups: comp.sys.sun.admin,comp.sys.sun.misc,comp.unix.solaris,
  556.         comp.answers,news.answers
  557.     Subject: FAQ: Sun Computer Administration Frequently Asked Questions
  558.  
  559.     2) The "Solaris 2 Porting FAQ" from David Meyer in this newsgroup.
  560.     For those developing or compiling software.
  561.     Archive-name: Solaris2/Porting.
  562.  
  563.     3) The "Solaris 2 x86 FAQ" from J. S. Caywood in this newsgroup.
  564.     Deals with Intel-("x86")-specific issues on Solaris 2.
  565.     Archive-name: Solaris2/x86 (proposed).
  566.  
  567.     4) comp.windows.open-look - Anything related to OpenWindows or the
  568.         OPEN LOOK Graphical User Interface.
  569.  
  570.     5) The Sun-Managers mailing list (see below) has its own FAQ,
  571.         maintained by John DiMarco <jdd@cdf.toronto.edu>.
  572.         FTP from ra.mcs.anl.gov in the sun-managers directory.
  573.  
  574.     6) See also the "Solaris SW list. Monthly Post" above and the
  575.         "whatlist" file.
  576.  
  577. 2.6) What mailing lists should I get?
  578.  
  579.     First, read all the USENET newsgroups with "sun" in their name :-)
  580.  
  581.     1) The Florida SunFlash is a "closed" mailing list for Sun owners.
  582.     It contains mostly press releases from Sun and third-party
  583.     vendors.  This list contains information on conferences such as
  584.     the Solaris Developer's Conference as well.  It is normally
  585.     distributed regionally - to find out about a mail point in your
  586.     area, or for other information send mail to info-sunflash@Sun.COM.
  587.  
  588.     Subscription requests should be sent to sunflash-request@Sun.COM.
  589.     Archives are on solar.nova.edu, ftp.uu.net, sunsite.unc.edu,
  590.     src.doc.ic.ac.uk and ftp.adelaide.edu.au
  591.  
  592.     2) The Sun Managers list is an unmoderated mailing list for
  593.     *emergency-only* requests. Subscribe and listen for a while,
  594.     and read the regularly-posted Policy statement BEFORE sending
  595.     mail to it, and to get a feel for what kinds of traffic it carries.
  596.     Write to sun-managers-request@eecs.nwu.edu.
  597.  
  598. 2.7) What books should I read?
  599.  
  600.     O'Reilly & Associates specializes in UNIX books.  Their "UNIX
  601.     In A Nutshell" has been updated for SVR4 and Solaris 2.0.  Get
  602.     their catalog by calling 800-998-9938 (1-707-829-0515) 7AM to
  603.     5PM PST.
  604.  
  605.     SunSoft Press carries books specific to Solaris 2. Look for the
  606.     inset with your End User Media Kit that lists the most relevant ones.
  607.  
  608.     Prentice-Hall has reprints of much of the AT&T documentation.
  609.     I'm not sure how much of this you need - a lot of the same
  610.     material is in the Answerbook (see above).
  611.  
  612. 3. SYSTEM ADMINISTRATION
  613.  
  614. 3.1) How much disk space do I need to install Solaris 2?
  615.  
  616.     A full install of 2.2 is supposed to be 164 MB, but that doesn't
  617.     include swap. Here is a net exchange between Casper Dik and Gil Tene:
  618.  
  619.     In article <1993Apr2.083549.19177@fwi.uva.nl>, Casper writes:
  620.     |> >How much disc space does SOLARIS take up ? That is should we buy a
  621.     |> >424Mb disc or get a 1Gb disc to put it on :-)
  622.     |> 
  623.     |> Solaris 2.x takes about as much diskspace as SunOS 4.x:
  624.     |> 
  625.     |> Partition/Slice Solaris SunOS
  626.     |> /        10MB     8MB
  627.     |> /usr        78MB    90MB
  628.     |> /var        10MB    10MB
  629.     |> /usr/openwin    83MB    83MB
  630.     |> 
  631.  
  632.     Gil replies:
  633.     On my system, with a full Solaris installation (EVERYTHING selected)
  634.     + gnu's binary stuff for solaris (off of the Catalyst CD) installed 
  635.     in /opt I see a similar situation to the above plus :
  636.  
  637.     16852   /opt/SUNWabe
  638.     19      /opt/SUNWcg12
  639.     7968    /opt/SUNWdiag
  640.     721     /opt/SUNWgt
  641.     7740    /opt/SUNWits
  642.     14609   /opt/cygnus-sol2-1.0
  643.  
  644.     (output from "du -k -s /du/*")
  645.  
  646.     - SUNWabe is the end user answerbook stuff.  (vi, mail, Deskset tools
  647.       etc, etc)
  648.  
  649.     - SUNWcg12 is (obviously) cg12 support.
  650.  
  651.     - SUNWdiag is obvious too.
  652.  
  653.     - SUNWgt is support for gt boards.
  654.  
  655.     - SUNWits is the xgl3.0 library (it has libPEX5.so.1 in there too).
  656.  
  657.     - cygnus-sol2-1.0 is the gcc2.0+tools stuff. I have gcc2.3.3 on 
  658.       another partition and that takes about the same space as 2.0 does.
  659.  
  660.     Another important note : The full Solaris 2.1 answerbook takes up 164MB
  661.     on disk. I highly recommend installing it and not using it off the
  662.     CDROM drive. It's much more usable (faster) this way. And it always
  663.     stays around -- even when you have something else in the CDROm drive.
  664.  
  665. 3.2) How can I convert all my local changes that I've made over the years
  666. into their corresponding forms on Solaris 2?
  667.  
  668.     1) Do it by hand. You did document every single change and
  669.     check it into RCS, didn't you?
  670.  
  671.     2) Automate it, using the AMToolkit (Administration Migration 
  672.     Toolkit) from the OpCom FTP server (q.v.)!
  673.  
  674. 3.3) What are "packages"?
  675.  
  676.     A SVR4 mechanism for "standardizing" the installation of
  677.     optional software. Most vendors are expected to use this
  678.     format for distributing add-on software for Solaris 2.x.
  679.  
  680.     Packages can be installed/deinstalled with pkgadd/pkgrm which
  681.     are standard SVR4 items, or with swm (CRT) or swmtool (GUI-based)
  682.     which are provided only in Solaris 2.
  683.  
  684.     Note that the "pkg" system keeps lots of files in /var/sadm/install,
  685.     and in particular the file "contents", which is hundreds of KB,
  686.     and that there are two copies of it while pkgadd is running, so you
  687.     needs lots of free space where /var is, typically the root.
  688.     This file must be kept around if you want, for example, to use
  689.     pkgrm to remove a package, or pkgchk to verify months later that
  690.     all of a a package's files are still intact.
  691.  
  692.     Summary of pkg* commands:
  693.  
  694.         pkginfo <pkg>    - test for presents of package.
  695.         pkgadd -d /<cdrom>/Solaris_2.3 <pkg ...>
  696.                 - add missing packages
  697.         pkgrm <pkg ...>    - remove packages.
  698.  
  699. 3.4) Why can't I write in /home?
  700.  
  701.     This is a common one! SunOS is delivered with the "automounter"
  702.     enabled. The automounter is designed for NFS sites, to
  703.     simplify maintenance of the list of filesystems that need
  704.     mounting. However it is a burden for standalone sites.
  705.  
  706.     The automounter takes over /home and in effect becomes the NFS
  707.     server for it, so it no longer behaves like a normal directory.
  708.     This is normally a Good Thing as it simplifies administration if
  709.     everybody's home directory is /home/<username>.
  710.  
  711.     To kill it off for standalone or small networks, you can comment out
  712.     the three lines in /etc/init.d/nfs.client that start "if" (from the if
  713.     to the fi!!), and reboot (Solaris 2.2) or remove the file
  714.     /etc/rc2.d/S73autofs (Solaris 2.3).  You can allways relink
  715.     that file with /etc/init.d/autofs if you change your mind.
  716.  
  717.     To learn about it, read the O'Reilly book "Managing NFS and
  718.     NIS", or ftp the white paper 'The Art of Automounting".  from
  719.     sunsite.unc.edu in the directory /pub/sun-info/white-papers.
  720.  
  721. 3.5) Why can't I access CDs or floppies?
  722.  
  723.     Solaris 2.2 introduces a new scheme for automatically mounting
  724.     removable media. It consists of a program "vold" (volume daemon) which
  725.     sits around watching for insertions of floppies and CD's,
  726.     handles ejects, talks to the file manager, and invokes a second
  727.     program called "rmmount" (removable media mounter) to mount the disk. 
  728.  
  729.     Note that on most SPARCstations, you must run "volcheck"
  730.     whenever you insert a floppy, as the floppy hardware
  731.     doesn't tell SunOS that a floppy was inserted.
  732.  
  733.     Advantages of this scheme:
  734.     - no longer need root; users can mount and unmount at will.
  735.     - can do neat tricks like automagically start "workman" or
  736.       other Audio CD player when audio CD inserted.
  737.     - extensible - developers can write their own actions
  738.  
  739.     Drawbacks:
  740.     - can no longer access /dev/rfd0 to get at floppy; must use
  741.       longer name like /vol/dev/rdsk/floppy0 
  742.     - similarly, CD's get mounted on /cdrom/VOLNAME/SLICE, e.g.,
  743.       /cdrom/solaris_2_2/s0 is slice 0 of the Solaris 2 CD
  744.       (nice that it does mount all the partitions, though!).
  745.  
  746.     To read or write a non-filesystem floppy (tar, cpio, etc),
  747.     put in the diskette and run "volcheck" to get it noticed; then access
  748.     /vol/dev/rfd0/unlabeled  (e.g. "tar tvf /vol/dev/rfd0/unlabeled").
  749.  
  750.     [Solaris 2.3: /vol/dev/rdiskette0/unlabeled, or
  751.               /vol/dev/aliases/floppy0.]
  752.  
  753.     If you want the old behaviour, it's been suggested that you
  754.     can comment out the vold startup in /etc/init.d/volmgt and
  755.     then reboot; an easier way is # /etc/init.d/volmgt stop.
  756.  
  757. 3.6) What is this junk mail about an error in the crontab entry?
  758.  
  759.     Solaris 2.1 (FCS on SPARC and OEM on Intel) shipped with a
  760.     blank line at the end of root's crontab file. The result is
  761.     that root gets mail at boot time and nightly thereafter,
  762.     complaining about an error in the crontab file and that it has
  763.     "ignored the entry".  Pretty hard work ignoring that blank
  764.     line, eh?  If the messages bug you (they should), su to root
  765.     and use "crontab -e" to edit root's crontab and delete the
  766.     blank line at the end of the file. Fixed in FCS on Intel
  767.     and 2.2 on SPARC.
  768.  
  769. 3.7) Why are there no passwords in /etc/passwd?
  770.  
  771.     System V Release 4 includes a feature called "shadow passwords".
  772.     The encrypted passwords are moved out into a shadow password file
  773.     (called /etc/shadow in this release) that is NOT publicly readable.
  774.     The passwd file has always been readable so that, for example, ls -l
  775.     could figure out who owns what. But having the passwd encryptions
  776.     readable is a security risk (they can't be decrypted but the bad guy
  777.     can encrypt common words and names &c and compare them with the
  778.     encryptions).
  779.  
  780.     The Shadow Password feature is mostly transparent, but if you
  781.     do any passwd hacking you have to know about it!  And DO make
  782.     sure that /etc/shadow is not publicly readable!
  783.  
  784. 3.8) Why can't I rlogin/telnet in as root?
  785.  
  786.     >... when I try to rlogin as root ...
  787.     >it gives me the message "Not on system console
  788.     >Connection closed.".  What have I left out?
  789.  
  790.     Solaris 2 comes out of the box a heck of a lot more secure than
  791.     Solaris 1.  There is no '+' in the hosts.equiv.  root logins are not
  792.     allowed anywhere except the console.  All accounts require passwords.
  793.     In order to allow root logins over the net, you need to edit the 
  794.     /etc/default/login file and comment out or otherwise change the 
  795.     CONSOLE= line.
  796.  
  797.     This file's CONSOLE entry can actually be used in a variety of ways:
  798.  
  799.         1) CONSOLE=/dev/console (default) - direct root logins only on console
  800.         2) CONSOLE= - direct root logins disallowed everywhere
  801.         3) #CONSOLE (or delete the line) - root logins allowed everywhere
  802.  
  803. 3.9) How can I set up anonymous FTP?
  804.  
  805.     If you need help, ftp the file "solaris2-ftp" from
  806.     ftp.cs.toronto.edu:/pub/darwin/solaris2.
  807.  
  808.     ftpd(1M) is nearly complete when it comes to setting
  809.     up anonymous ftp.  It only leaves out /etc/nsswitch.conf. [S2.3]
  810.  
  811. 3.10) How can I print from a Solaris 2 (or any System V Release 4) system to
  812. a SunOS4.x (or any other BSD) system?
  813.  
  814.     Hmmm, the lp system is totally different than what you're used to.
  815.     The System V Line Printer System is a lot more, well, flexible.
  816.     A cynic might say "complicated".  Here's a very quick guide --
  817.     see the man pages for each of these commands for the details.
  818.  
  819.     Let's say your Solaris2 workstation is called "sol" and the
  820.     4.1.x server is called "bertha" and you want the printer name
  821.     to be "printer" (imaginative, eh?).
  822.  
  823.     sol# lpsystem -t bsd bertha        # says bertha is a bsd system
  824.     sol# lpadmin -p printer -s bertha    # creates "printer" on "sol"
  825.                         # to be printed on "bertha"
  826.     sol# accept printer            # allow queueing
  827.     sol# enable printer            # allow printing
  828.     sol# lpstat -t                # check the status
  829.  
  830.     Finally, if that's your only printer, make it the default:
  831.  
  832.     sol# lpadmin -d printer
  833.  
  834.     On some systems you may have to turn on the port monitor.
  835.  
  836. I did that. Why does it now complain about invalid content types?
  837.  
  838.     I said it was complicated!
  839.  
  840.     For better or for worse, you need to know about printer content types.
  841.     See the man page for "lpadmin".
  842.  
  843.     To get transparent mode, try this:
  844.  
  845.     lpadmin -I any -p printer
  846.  
  847. Isn't there any easier way?
  848.  
  849.     The GUI-based Admintool has a Printer Manager that is supposed to
  850.     be able to do all this and more. Try it; Sun hopes you'll like it.
  851.  
  852. Now my jobs print but they stay in the queue after!?
  853.  
  854.     It's a known bug, and probably get fixed in 2.3.
  855.     There's also a number of lpsched patches out for
  856.     Solaris: 101025-xx (2.2) and 101317-xx (2.3).
  857.     Make sure you install those.
  858.  
  859.     [Now you want to set up Solaris 2 as a print server?
  860.     You're on your own.]
  861.  
  862. 3.11) What if I'd rather use the old familiar BSD-style line printer system?
  863.  
  864.     The 4.3BSD-reno lpr system for Solaris 2, file
  865.         lpr-sol2.tar.gz or lpr-sol2.tar.Z 
  866.     is available from the following FTP sites:
  867.  
  868.     sunok-wks.acs.ohio-state.edu:/pub/solaris2/src/lpr-sol2.tar.gz
  869.     atlas.ce.washington.edu:/pub/lpr-sol2.tar.Z
  870.     solomon.technet.sg:/pub/uploads/unix/lpr-sol2.tar.gz
  871.  
  872. And don't despair.  Someday the System V print spooler will be replaced
  873. by something new.  (See the Solaris 2.3 Open Issues & Late Breaking News
  874. For System dministrators)
  875.  
  876.  
  877. 3.12) What happened to /dev/MAKEDEV? How do I add devices?
  878.  
  879.     Device drivers are linked in dynamically. When you add new
  880.     devices, just shutdown the system and do
  881.         boot -r    # use drive spec if not default disk
  882.     to *r*ebuild the /devices and /dev directories.
  883.  
  884.     If you're just adding a SCSI disk, you don't need to reboot.  Run the
  885.     following script (as root):
  886.  
  887.         #!/bin/sh
  888.         #
  889.         # add-disk
  890.         #
  891.         #       Runs the commands to make Solaris locate a new disk that
  892.         #       has been plugged in after the system was booted.
  893.         #
  894.  
  895.         _DVFS_RECONFIG=YES; export _DVFS_RECONFIG  # Solaris 2.1
  896.         _INIT_RECONFIG=YES; export _INIT_RECONFIG  # Solaris 2.[23]
  897.  
  898.         /etc/init.d/drvconfig
  899.         /etc/init.d/devlinks
  900.  
  901.         exit 0
  902.  
  903.     Note that this only works if you already have at least one SCSI disk on
  904.     the system.  (This is because the above just makes symbolic links and
  905.     things, it does not load up the SCSI driver kernel modules, etc.)
  906.  
  907. 3.13) What happened to /etc/rc and /etc/rc.local?
  908.  
  909.     They're now fragmented into 12 million tiny little pieces. Look in 
  910.     the following files to get oriented:
  911.         /etc/inittab - starting point for init
  912.         /sbin/rcS, /etc/rcS.d/* - booting stuff
  913.         /sbin/rc2, /etc/rc2.d/*,
  914.             /sbin/rc3, /etc/rc3.d/* - stuff for multi-user startup.
  915.     Note that all files in /etc/rc*.d/* are hardlinked from
  916.     /etc/init.d (with better names), so you should grep in there.
  917.  
  918.     There are many "run levels" to the System V init; the run
  919.     level 3 is normally used for "multi user with networking."
  920.  
  921. I can't understand that stuff; can't I have /etc/rc.local back?
  922. I just want to keep all my local changes in one place.
  923.  
  924.     No. You can never have rc.local back the way it was. But then, it
  925.     never really *was* purely a "local" rc file. To have a real
  926.     "local" rc file with just your changes in it, copy this file
  927.     into /etc/init.d/rc.local, and ln it to /etc/rc3.d/S99rc.local.
  928.     Put your startup stuff in the "start" section.
  929.  
  930.     ----- Cut here -----
  931.     # /etc/init.d/rc.local - to be linked into /etc/rc3.d as 
  932.     # S99rc.local -- a place to hang local startup stuff.
  933.     # started after everything else when going multi-user.
  934.  
  935.     # Ian Darwin, Toronto, November, 1992
  936.     # As with all system changes, use at own risk!
  937.  
  938.     case "$1" in
  939.     'start')
  940.         echo "Starting local services...\c"
  941.  
  942.         if [ -f /usr/sbin/mydaemon ]; then
  943.             /usr/sbin/mydaemon 1>/dev/console 2>&1
  944.         fi
  945.         echo ""
  946.         ;;
  947.     'stop')
  948.         echo "$0: Not stopping any service - use ucb shutdown for that."
  949.         ;;
  950.     *)
  951.         echo "Usage: $0 { start | stop }"
  952.         ;;
  953.     esac
  954.     ------ End of Cut Here -----
  955.  
  956. 3.14) Speaking of that, why are there two versions of shutdown?
  957.     SVR4 (hence SunOS 5.x) tries to make everybody happy. The
  958.     traditional (slow) System V "shutdown" runs all the rc?.d/*
  959.     shell scripts with "stop" as the argument; many of them run
  960.     ps(!) to look for processes to kill. The UCB "shutdown" tells
  961.     init to kill all non-single-user processes, which is about two
  962.     orders of magnitude faster. Unfortunately, the UCB version does
  963.     everything it should *except* actually halt or reboot in
  964.     SunOS5.1 (and some other SVR4 implementations).
  965.     This is fixed in Solaris 2.3.
  966.  
  967.     If you run a database (like oracle) or INN, you should
  968.     install a special /etc/rc?.d/K* script and make sure you
  969.     always shutdown the long way.
  970.  
  971. 3.15) When will somebody publish a package of the BSD (4.3BSD Net2) "init",
  972.     "getty", and "rc/rc.local", so we can go back to life in the
  973.     good old days?
  974.  
  975.     Getty should be easy and was reportedly done at a number of
  976.     sites.  The portmonitor isn't everyones favourite.  But given
  977.     that you can do much more with the SVR4 init, why would
  978.     you want to change back?  It would be much more trouble than
  979.     it's worth.
  980.  
  981. 3.16) What has happened to getty? What is pmadm and how do you use it?
  982.  
  983.     I was hoping you wouldn't ask. PMadm stands for Port Monitor Admin,
  984.     and it's part of a ridiculously complicated bit of software
  985.     over-engineering that is destined to make everybody an expert.
  986.  
  987.     Best advice for workstations: don't touch it! It works out of the box.
  988.     For servers, you'll have to read the manual.
  989.     This should be in admintool in Solaris2.3.
  990.     For now, here are some basic instructions from Davy Curry.
  991.  
  992.     "Not guaranteed, but they worked for me."
  993.  
  994.     To add a terminal to a Solaris system:
  995.  
  996.     1. Do a "pmadm -l" to see what's running.  The serial ports on the 
  997.     CPU board are probably already being monitored by "zsmon".
  998.  
  999.     PMTAG          PMTYPE         SVCTAG         FLGS ID       <PMSPECIFIC>
  1000.     zsmon          ttymon         ttya           u    root     \
  1001.         /dev/term/a I - /usr/bin/login - 9600 ldterm,ttcompat ttya \
  1002.         login:  - tvi925 y  #
  1003.  
  1004.     2. If the port you want is not being monitored, you need to create a
  1005.     new port monitor with the command
  1006.  
  1007.         sacadm -a -p PMTAG -t ttymon -c /usr/lib/saf/ttymon -v VERSION
  1008.  
  1009.     where PMTAG is the name of the port monitor, e.g. "zsmon" or "alm1mon",
  1010.     and VERSION is the output of "ttyadm -V".
  1011.  
  1012.     3. If the port you want is already being monitored, and you want to 
  1013.     change something, you need to delete the current instance of the port
  1014.     monitor.  To do this, use the command
  1015.  
  1016.         pmadm -r -p PMTAG -s SVCTAG
  1017.  
  1018.     where PMTAG and SVCTAG are as given in the output from "pmadm -l".  Note
  1019.     that if the "I" is present in the <PMSPECIFIC> field (as it is above),
  1020.     you need to get rid of it.
  1021.  
  1022.     4. Now, to create a specific instance of ttymon for a port, issue the
  1023.     command:
  1024.  
  1025.     pmadm -a -p PMTAG -s SVCTAG -i root -fu -v 1 -m \
  1026.         "`ttyadm -m ldterm,ttcompat -p 'PROMPT' -S YORN -T TERMTYPE \
  1027.         -d DEVICE -l TTYID -s /usr/bin/login`"
  1028.  
  1029.     Note the assorted quotes; Bourne shell (sh) and Korn (ksh) users
  1030.     leave off the second backslash!
  1031.  
  1032.     In the above:
  1033.  
  1034.     PMTAG is the port monitor name you made with "sacadm", e.g. "zsmon".
  1035.  
  1036.     SVCTAG is the service tag, which can be the name of the port, e.g.,
  1037.             "ttya" or "tty21".
  1038.  
  1039.     PROMPT is the prompt you want to print, e.g. "login: ".
  1040.  
  1041.     YORN is "y" to turn software carrier on (you want this for directly
  1042.     connected terminals" and "n" to leave it off (you want this
  1043.     for modems).
  1044.  
  1045.     TERMTYPE is the value you want in $TERM.
  1046.  
  1047.     DEVICE is the name of the device, e.g. "/dev/term/a" or "/dev/term/21".
  1048.  
  1049.     TTYID is the line you want from /etc/ttydefs that sets the baud rate
  1050.         and stuff.  I suggest you use one of the "contty" ones for
  1051.         directly connected terminals.
  1052.  
  1053.     5. To disable ("turn off") a terminal, run
  1054.  
  1055.         pmadm -d -p PMTAG -s SVCTAG
  1056.  
  1057.     To enable ("turn on") a terminal, run
  1058.  
  1059.     pmadm -e -p PMTAG -s SVCTAG
  1060.  
  1061.     Ports are enabled by default when you "create" them as above.
  1062.  
  1063.     For more details, see the article:
  1064.         SUMMARY: Solaris modem/terminal how-to: Rev xx.xx.xx
  1065.     posted periodically to comp.unix.solaris by
  1066.     celeste@xs.com (Celeste Stokely).
  1067.  
  1068. 3.17) How do I get the screen to blank when nobody's using it?
  1069.  
  1070.     Under 4.1.x you invoke screenblank in /etc/rc.local, but there's no
  1071.     screenblank in Solaris 2.1.  Sun recommends that you
  1072.     have everybody put `xset s on' in their .xinitrc, but this
  1073.     may be hard to police, and in any event it won't work when nobody is
  1074.     logged in.  The simplest workaround is to copy /usr/bin/screenblank
  1075.     from 4.1.x and run it in binary compatibility mode.  See ``What
  1076.     happened to /etc/rc and /etc/rc.local?'' for how to invoke it.
  1077.  
  1078.     Another possibility is to use xdm, but you'll have to use your own,
  1079.     since the xdm shipped with Solaris 2.1 doesn't work.
  1080.  
  1081.     The 4.1.x screenblank didn't work for me; I use Jef Poskanzer's
  1082.     freeware screenblank (FTP it from various archive sites,
  1083.     two of them listed in the next item).
  1084.  
  1085.     Because of a bug in Solaris 2.3, you'll need to change to
  1086.     use latest version of screenblank.
  1087.  
  1088. 3.18) And what about screendump, screenload and clear_colormap?
  1089.  
  1090.     You can FTP Jef's screenload, screendump, etc., if you need that
  1091.     functionality, and for free you get a pixrect (clone) library.
  1092.     Get one of these:
  1093.         netcom.com:pub/jef/raster-pixrect_30dec93.tar.Z
  1094.         ee.lbl.gov:raster-pixrect_30dec93.tar.Z
  1095.  
  1096.     The 4.1.x versions of these programs will not run under
  1097.     Solaris 2.2 or later.  The pixrect BCP library is no
  1098.     longer supported.
  1099.  
  1100. 3.19) Where did etherfind go?
  1101.  
  1102.     There is a replacement for etherfind, but it has changed name;
  1103.     in fact it's a whole new program. It IS better. To find it,
  1104.     though, you would have to realize that network snooping is not
  1105.     really ethernet-specific.  To end the suspense :-), here it is:
  1106.  
  1107.     % man -k snoop
  1108.     snoop    snoop (1m)    - capture network packets and inspect them
  1109.     %
  1110.  
  1111.     It works differently - it has an immediate mode, a capture-to-disk mode,
  1112.     and a playback-from-disk mode.  Read the man page for details.
  1113.  
  1114. 3.20) Can I run SunOS4.1.x on my SPARC Classic or LX?
  1115.  
  1116.     Yes, because users wanted it (and because Clone makers were providing
  1117.     it), Sun has now released a version of Solaris 1 (SunOS 4.1.3)
  1118.     specifically for these machines.  That version is called 4.1.3C
  1119.     or Solaris 1.1C.  Recently, Sun released a new end-of-life
  1120.     release of SunOS 4.1.x, 4.1.3_U1 (Solaris 1.1.1).  This
  1121.     release supports the LX and Classic as well.  Suns newest
  1122.     models based on the MicroSPARC II will be supported in a
  1123.     SunOS 4.1.x release as well.
  1124.  
  1125. 3.21) The "find" program complains that my root directory doesn't exist?
  1126.  
  1127.     Yes! Actually, messages like
  1128.  
  1129.     find : cannot open /: No such file or directory.
  1130.  
  1131.     are due to a bug in the tree walking function (nftw(3)).  If it
  1132.     runs into problems traversing the tree, it gives up and
  1133.     incorrectly complains about the top level directory of the
  1134.     tree.  [The submitter seems] to recall that the most common
  1135.     case which caused trouble was a directory somewhere in the
  1136.     directory hierarchy which was readable but not executable.
  1137.     With the fix it will just complain about the directory to which
  1138.     it couldn't chdir and skip descending that subtree.
  1139.  
  1140.  
  1141. 3.22) I'm having troubles with high-speed input on the Sparc serial ports.
  1142. What should I do?
  1143.  
  1144.     Try using UUCP.  The Solaris 2.x sparc serial driver has trouble
  1145.     receiving data at or above 9600 bps.  Symptoms include sluggish
  1146.     response, `NOTICE: zs0: silo overflow' console messages, sending
  1147.     spurious control-Gs to the serial port, and applications that cannot be
  1148.     killed even with `kill -9'.  This problem surfaces in many
  1149.     applications, including Kermit and tip.  UUCP seems immune, though,
  1150.     because its protocol throttles input sufficiently.
  1151.  
  1152. 3.23) How do I make ksh or csh be the login shell for root?
  1153.  
  1154.     Root's shell is /sbin/sh, which is statically linked.
  1155.     Don't just insert a 'c' before "sh" as previously, as that would
  1156.     look for /sbin/csh, which doesn't exist.  Don't just change it to 
  1157.     /bin/csh, since that's really /usr/bin/csh, which is dynamically
  1158.     linked, because:
  1159.         a) /usr may not be mounted initially, and then
  1160.            you're in deep (the shared libraries are in /usr!), and
  1161.         b) There is code in the startup scripts that assumes that
  1162.            everything critical is in /etc/lib, not /usr/lib.
  1163.     Approach with caution!
  1164.  
  1165.     Safer bet - have an alternate root account, like "rootcsh",
  1166.     with uid 0, and /bin/csh as its shell. Put it after root's entry in
  1167.     the passwd file.  Only drawback: you now have to remember to
  1168.     change all of root's passwds at the same time.
  1169.  
  1170.     Third bet - in root's .profile, check if /usr is mounted and, if so,
  1171.     exec /bin/ksh or whatever.
  1172.  
  1173. 3.24) What is this message: "automount: No network locking on thathost,
  1174.     contact administrator to install server change."?
  1175.  
  1176.     The other machine (an NFS server) is running 4.1.x and needs a
  1177.     patch from Sun to update its network lock daemon (lockd). If
  1178.     you don't install the patch on the server, file locking will
  1179.     not work on files mounted from "thathost". The 100075-xx patch
  1180.     fixes a bunch of other lock manager problems, so it may be a
  1181.     Good Thing To Get; however, it may also cause the machine on
  1182.     which the patch is installed to have trouble talking to servers
  1183.     with no patch or older patches, so Be Warned.
  1184.  
  1185. 3.25) How do I make Solaris2 use my Toshiba MK538FB drives?
  1186.  
  1187.     Append this line to /etc/system and reboot:
  1188.  
  1189.     set scsi_options=0x78
  1190.  
  1191.     This turns off Command Queueing, which upsets the Toshiba
  1192.     and some other drives.  If you have fast SCSI, you must use:
  1193.  
  1194.     set scsi_options=0x178
  1195.  
  1196.     or you end up disabling fast SCSI as well.
  1197.  
  1198. 3.26) How do I make Solaris2 use my old ADAPTEC ACB-4000 and Emulex MD-21 disks?
  1199.  
  1200.     As with any hardware addition, first try the obvious (boot -r
  1201.     after installing and power-cycling everything).
  1202.  
  1203.     The adaptec is no longer supported; man -s7 sd no longer even
  1204.     lists it!  So I guess they go over the cliff. Either that, or
  1205.     take the drives out and put them on a PC, where ST506 MFM
  1206.     drives are still supported.
  1207.  
  1208.     The MD21 should work, though some people report that SCSI
  1209.     doesn't work in 4/260 boxes (bug-id #11187521).
  1210.  
  1211. 3.27) Why are there so many patches for Solaris 2.3? It's only been out a month!
  1212.  
  1213.     Solaris 2.x releases are essentially frozen TWO months before
  1214.     their general release date.  During the early access/beta test
  1215.     period bugs are found both in the beta and in the previous
  1216.     release.  That's why at the moment a new release comes out a
  1217.     number of patches is ready. Some of those are on the Solaris
  1218.     2.3 CD.  Others were released almost at the same time as 2.3.
  1219.  
  1220.     Solaris 2.3 is not a bug fix release.  Although tons of bugs
  1221.     were fixed, a number of changes have been made and a number of
  1222.     new features were introduced:
  1223.  
  1224.     * OpenWin moved from NeWS based to X11R5+DPS based. (needs 101362-11)
  1225.     + PPP (needs 101425)
  1226.     + AutoFS (needs 101329-10 & 101500-02)
  1227.     + CacheFS
  1228.     + Easier NIS+ conversion
  1229.     + BCP for statically linked executables.
  1230.  
  1231.     And another user writes:
  1232.  
  1233.     Be thankful you don't have to use IBM's AIX.  For that you get
  1234.     a new release and then about 100 patches per WEEK!
  1235.  
  1236. 3.28) What are the ``mandatory'' patches I keep hearing about?
  1237.  
  1238.     The mandatory patches weren't mandatory, so they've been relabeled.
  1239.     They're now called ``recommended'' patches.
  1240.  
  1241.     The recommended patches are those patches Sun recommends for
  1242.     trouble free system operation.  With those patches installed,
  1243.     your chances on trouble free operation are higher.  That doesn't
  1244.     mean you will run into trouble without them.
  1245.  
  1246. 3.29) Where do I get patches from?
  1247.  
  1248.     thor.ece.uc.edu:/pub/sun-faq/Solaris2.[123]-patches.
  1249.  
  1250.     (SunOS 4.1.x patches in: /pub/sun-faq/SunOS4.1.x.Patches)
  1251.  
  1252.     ugle.unit.no:/pub/unix/sun-fixes
  1253.  
  1254.     Starting with SunSolve CD 2.1.2 ALL Sun patches are shipped
  1255.     on the SunSolve CD.
  1256.  
  1257.     Contract customers can get patches by ftp from Sun sites
  1258.     or via e-mail and query one of the online sunsolve-databases
  1259.     on the internet.
  1260.  
  1261. 3.30) Why does installing patches take so much space in /var/sadm?
  1262.  
  1263.     All the files that are replaced by a patch are stored under
  1264.     /var/sadm/patch/<patch-id>/save so the patch can be backed
  1265.     out safely.
  1266.  
  1267.     You can remove the <patchdir>/save directory provided you also
  1268.     remove the <patchdir>/.oldfilessaved file.
  1269.  
  1270.     Alternatively, you can install a patch w/o saving the old
  1271.     files.
  1272.  
  1273. 3.31) Do I need to back out previous versions of a patch?
  1274.  
  1275.     No, unless otherwise stated in the patch README.
  1276.     If the previous patch installation saved the old
  1277.     files, you may want to reclaim that space.
  1278.  
  1279.     Patches can be backed out with:
  1280.     
  1281.         /var/sadm/patch/<patch-id>/backoutpatch <patch-id>
  1282.  
  1283.     Backoutpatch can take an awful long time, especially when the
  1284.     patch contained a lot of files.
  1285.  
  1286. 3.32) How can I have more than 48 pseudo-ttys?
  1287.  
  1288.     Edit /etc/system and add the following line:
  1289.  
  1290.     * System V pseudo terminals
  1291.  
  1292.     set pt_cnt = <num>
  1293.  
  1294.     * BSD pseudo ttys
  1295.  
  1296.     set npty = <num>
  1297.  
  1298.     Halt the system and boot -r.
  1299.  
  1300. 3.33) I messed up /etc/system, now I can't boot.
  1301.  
  1302.     Boot with -as.  The kernel will ask you all sorts of questions,
  1303.     including the name of the system file.  Use the previous
  1304.     /etc/system file or specify /dev/null.
  1305.  
  1306.  
  1307. 4. NETWORKING
  1308.  
  1309. 4.1) Can I use DNS with Solaris 2.x?
  1310.  
  1311.     It seems that the in.named included in the Solaris 2.1 distribution
  1312.     is terribly unstable. The easiest solution for now I have discovered
  1313.     is to use the OLD (SunOS 4.1.2 in my case) in binary compatibility
  1314.     mode. This works just fine. If it's slower I can't tell.
  1315.     There's also a patch (100902-01) available now for 2.1.
  1316.     It works in Solaris 2.2 and later.
  1317.  
  1318.  
  1319. 4.2) How do I use DNS w/o using NIS or NIS+?
  1320.  
  1321.     Under SunOS 4.1 it was next to impossible to run DNS name resolution
  1322.     without either a kludge fix or the NIS (V2 I guess). Under Solaris
  1323.     2.1 it is incredibly simple, but you must ignore what the manual
  1324.     (SunOS 5.1 Administering NIS+ and DNS) says (the manual is fixed
  1325.     in Solaris 2.2). All that is required to make a non-NIS host
  1326.     use the DNS for name resolution is to change the host: line in
  1327.     the /etc/nsswitch.conf file to the following:
  1328.  
  1329.     hosts:    files dns
  1330.  
  1331.     (i.e., when looking for hosts, look in /etc/hosts first, if not
  1332.     found there, try DNS, if still not found then give up) and set
  1333.     up a correct version of /etc/resolv.conf to tell the resolver
  1334.     routines (like gethostbyname) how to contact the DNS
  1335.     nameserver. You must have the names of machines which are
  1336.     somehow contacted during boot in the files in /etc and files
  1337.     must appear first in the hosts: line, otherwise the machine
  1338.     will hang during boot (at least ours did). Make sure that
  1339.     /etc/netconfig is using switch.so. (It does from the factory.)
  1340.  
  1341.  
  1342. 4.3) Speaking of nsswitch.conf, what is it?
  1343.  
  1344.     An idea whose time has come (it came to Ultrix a few years
  1345.     ago).  You can control which of the "resolver" services are
  1346.     read from NIS (formerly YP), which from NIS+, which from the
  1347.     files in /etc, and which are from DNS (but only "hosts" can
  1348.     come from DNS).
  1349.  
  1350.     A common example would be:
  1351.  
  1352.     hosts: nis files
  1353.  
  1354.     which means ask NIS for host info and, if it's not found, try
  1355.     the local machine's host table as a fallback.
  1356.  
  1357.     Advice: if you're not using NIS or DNS, suninstall probably put the
  1358.     right version in. If you are, ensure that hosts and passwd come from
  1359.     the network. However, many of the other services seldom if ever change.
  1360.     When was that last time *you* added a line in /etc/protocols? If your
  1361.     workstation has a local disk, it may be better to have programs
  1362.     on your machine look up these services locally, so use "files".
  1363.  
  1364.     Terminology: Sun worried over the term "resolver", which
  1365.     technically means any "get info" routine (getpwent(3),
  1366.     gethostbyname(3), etc), but is also specifically attached to
  1367.     the DNS resolver.  Therefore they used the term "source" to
  1368.     mean the things after the colon (files/DNS/NIS/NIS+) and
  1369.     "database" to mean the thing before the colon
  1370.     (passwd/group/hosts/services/netgroup etc).
  1371.  
  1372.     A complete discussion can be found in nsswitch.conf(4).
  1373.  
  1374.  
  1375. 4.4) So what does [NOTFOUND=return] in nsswitch.conf mean, and where does it go?
  1376.  
  1377.     Type "man nsswitch.conf" for more info.  There is too much
  1378.     detail to summarize here.  Briefly, [NOTFOUND=return] means
  1379.     that the name service whose entry it *follows* should be
  1380.     considered authoritative (so that if it's up and it says such a
  1381.     name doesn't exist, believe it and return instead of continuing
  1382.     to hunt for an answer).
  1383.  
  1384. 4.5) Can I run a nis/yp server under Solaris 2.x?
  1385.  
  1386.     Yes, you need the Solaris network transition kit available from
  1387.     Sun.  However, his kit does not include the securenets patch.
  1388.  
  1389. 4.6) Can I run NIS+ under Solaris 1 (SunOS 4.1.x)
  1390.  
  1391.     Sort of, with the NIS+ server implementation for Solaris 1.x
  1392.     that comes on the Solaris 2.x CD.  This is a server side only
  1393.     implementation and requires NIS+ to run in YP compatibility
  1394.     mode.
  1395.  
  1396. 4.7) With NIS+ how do I find out which machine a client is bound to?
  1397.  
  1398.     Nis+ clients do not hard bind to nis+ servers in the same
  1399.     way that nis clients bind to nis servers. The clients have a
  1400.     list of nis+ servers within the cold-start file. When they need
  1401.     to do a lookup they do a type of broadcast called a "manycast"
  1402.     and talk to the first server that responds. This way they can
  1403.     be sure to use the lightest loaded server for the request.
  1404.  
  1405. 4.8) Ypcat doesn't work on the netgroup table on a NIS+ server, why?
  1406.  
  1407.     Yes, that is a known problem.  The only operations allowed from
  1408.     a NIS client side on the netgroup table are the ypmatches, but
  1409.     not ypcat (i.e. no support for yp_first(), yp_next() or
  1410.     yp_all() calls).  The netgroup table is kind of unique in
  1411.     this.  The reason for this is that the netgroup table format
  1412.     changed quite significantly in NIS+ and the NIS+ server would
  1413.     take a big performance hit in converting the netgroups table to
  1414.     YP (key-value) format.
  1415.  
  1416. 4.9) Why is rpc.nisd such a memory pig according to ps?
  1417.  
  1418.     The good news is that it's not memory OR swap space you're
  1419.     being shown by 'ps'.  Instead it's showing you the process
  1420.     ADDRESS space which includes 256 MB of address space reserved
  1421.     for the NIS+ transaction log.  Given the cost of moving things
  1422.     around in memory and the fact that we have 4 GB of address
  1423.     space to play with it, this is a good idea.  You've just got to
  1424.     stop thinking small.  THINK BIG.  It's only 1/16th of the total
  1425.     process address space being used.  And if you ever exceed the
  1426.     256 MB size of the transaction log you're doing something VERY
  1427.     wrong.
  1428.  
  1429. 5. TROUBLE SHOOTING
  1430.  
  1431. 5.1) Why can't I run Answerbook on a standalone machine?
  1432.  
  1433.     This is a bug in openwindows.  Using xhost + or starting
  1434.     openwin -noauth works around this problem.  This is
  1435.     only recommended for stand-alone machines with no dial-in
  1436.     users.
  1437.  
  1438. 5.2) Why can't I run filemgr, I get ``mknod: permission denied''?
  1439.  
  1440.     This is a symptom of a bug in filemgr.
  1441.     Either apply patch #101514 or run the following commands
  1442.     at system start-up:
  1443.          mkdir /tmp/.removable
  1444.          chmod a+rwxt /tmp/.removable
  1445.  
  1446. 5.3) Why do I get isinf undefined when linking with libdps?
  1447.  
  1448.     That's a bug in libdps.  Sun compiles and links its software
  1449.     with its own compilers.  The isinf() function is shipped with
  1450.     the SunPRO compilers, but not defined in any Solaris 2.x library.
  1451.  
  1452.     A workaround exists, and consists of adding the following to
  1453.     your program:
  1454.  
  1455.     int isinf(double x) { return !finite(x); }
  1456.  
  1457.     This isn't 100% correct, as this doesn't account for NaNs.
  1458.  
  1459. 5.4) I can't get PPP to work between Solaris 2.3 and other platforms.
  1460.  
  1461.     The PPP shipped with Solaris 2.3 doesn't interoperate with
  1462.     other PPP implementations.  Patch #101425 fixes this.
  1463.  
  1464. 5.5) Using compat mode for passwd doesn't work in 2.3?
  1465.  
  1466.     You need patch #101448.
  1467.  
  1468. 5.6) Why do I get __builtin_va_alist or __builtin_va_arg_incr undefined?
  1469.  
  1470.     You're using gcc without properly installing the gcc fixed
  1471.     include files.  Or you ran fixincludes after installing gcc
  1472.     w/o moving the gcc supplied varargs.h and stdarg.h files
  1473.     out of the way and moving them back again later.  This often
  1474.     happens when people install gcc from a binary distribution.
  1475.     If there's a tmp directory in gcc's include directory, fixincludes
  1476.     didn't complete.  This can happen when you run fixincludes in
  1477.     the background w/o redirecting I/O.
  1478.  
  1479.     Another possible cause is using ``gcc -I/usr/include.''
  1480.  
  1481. 5.7) My machine hangs during the boot process.  It seems related to ps.
  1482.  
  1483.     When the system boots, the first invocation of ps will try to
  1484.     recreate /tmp/ps_data.  To this end ps scans the /dev tree.
  1485.     Under some circumstances, a loop exists in /dev and ps will
  1486.     run forever.  Most of the time this loop is caused by the symbolic
  1487.     link /dev/bd.off.  While this link usually points to /dev/term/b,
  1488.     it sometimes get truncated and points to /dev instead.
  1489.  
  1490.     Fix: rm -f /dev/bd.off; ln -s /dev/term/b /dev/bd.off
  1491.  
  1492.     Use truss(1) to determine whether this is real the cause of your
  1493.     problem.
  1494.  
  1495.  
  1496. 6. SOFTWARE DEVELOPMENT
  1497.  
  1498. 6.1) Where is the C compiler or where can I get one?
  1499.  
  1500.     Where have you been? :-) Sun has dropped their old K&R C
  1501.     compiler, supposedly to create a market for multiple compiler
  1502.     suppliers to provide better performance and features.  Here
  1503.     are some of the contenders:
  1504.  
  1505.     1) SunPro C:
  1506.  
  1507.     SunPro, SMCC, and various distributors sell a new
  1508.     ANSI-standard C compiler on the unbundled (extra cost)
  1509.     SPARCcompiler/SPARCworks CD-ROM.  There are some other nice
  1510.     tools there too, like a "make tool" and a visual idiff
  1511.     (interactive diff).
  1512.  
  1513.     You have to license and pay per user.  Here's what seems to be
  1514.     their current (June 93) prices per user, in various quantities:
  1515.  
  1516.  SunPro:          Q1      Q2      Q5      Q10     Q20     Q25     Q50    Q100
  1517.  C, no supp       995     995     950     750     700     680     640     600
  1518.  1yr C & supp    1355    1355    1310    1110    1080    1040    1000     960
  1519.  2yr C & supp    1835    1835    1790    1590    1560    1520    1480    1440
  1520.  3yr C & supp    2315    2315    2270    2070    2040    2000    1960    1920
  1521.  
  1522.     (The "no support" price actually includes three months of
  1523.     support under warrantee.  One catch with Sun support is that
  1524.     to get *any* support, you have to pay for support for *all*
  1525.     the users at your site.  The quantity prices are only available
  1526.     in fixed size chunks.  You don't actually buy multiple years
  1527.     up front, but renew each year if desired.)
  1528.  
  1529.     One misfeature is that these tools use a floating license
  1530.     manager, so your whole staff can't use them without paying
  1531.     large sums of money.  Not only that, but as shipped, the tools
  1532.     enforce a 15-minute minimum usage time, to "encourage" you to
  1533.     buy a "floating" license for each and every actual user.  This
  1534.     caused so much screaming and tearing of hair that Sun was
  1535.     forced to fix it.  New compiler releases after May 1993 have a
  1536.     default 5 minute setting, changeable all the way to zero by
  1537.     having the sysadmin edit the "options file".  However, if you
  1538.     set it to zero, the compiler slows down, since it has to talk
  1539.     to the license daemon for every file you compile.  Old
  1540.     compilers have a patch available from SunPro to eliminate the
  1541.     15 minute limit; patch numbers: C: 100966-0x; C++: 100967-0x;
  1542.     Fortran: 100968-0x; Pascal: 100969-0x.  These patches are bulky
  1543.     and are not available at many anonymous ftp sites.
  1544.     If you have support, you can get them from Sun.
  1545.  
  1546.     2) Cygnus GCC:
  1547.  
  1548.     Cygnus Support and the Free Software Foundation make the GNU C
  1549.     compiler for Solaris, a free software product.  Source code
  1550.     and ready-to-run binaries are available by FTP from
  1551.     ftp.uu.net:/vendor/cygnus, or can be installed from the CDware
  1552.     CD (Volume 4 or 5).
  1553.  
  1554.     Like all GNU software, there are no restrictions on who can
  1555.     use it, how many people can use it at a time, what machines it
  1556.     can be run on, or how many copies you can install, run, give
  1557.     away, or sell.
  1558.  
  1559.     Cygnus sells technical support for these tools, under annual
  1560.     support contracts.  Price per user (June 93):
  1561.  
  1562.  Cygnus:          Q1      Q2      Q5      Q10     Q20     Q25     Q50    Q100
  1563.  C, no supp         0       0       0       0       0       0       0       0
  1564.  1yr C & supp    1400     700     580     540    ...                      504
  1565.  2yr C & supp    2800    1400    1160    1080    ...                     1008
  1566.  3yr C & supp    4200    2100    1740    1620    ...                     1512
  1567.  
  1568.     (If you get the compiler from one of the free distribution
  1569.     sites, there is no cost but no warrantee.  Cygnus lets you buy
  1570.     support for any number of users, at $500/user after the first
  1571.     two users at $1400.  You don't actually buy multiple years up
  1572.     front, but renew each year if desired.)
  1573.  
  1574.     The Cygnus distribution includes:
  1575.     gcc (ansi C compiler), gdb (good debugger), byacc (yacc repl),
  1576.     flex (lex repl), gprof, makeinfo, texindex, info, patch,
  1577.     cc (a link to gcc)
  1578.  
  1579.     The Cygnus compiler on uunet is starting to show its age a
  1580.     bit.  If you want to compile X11R5, you can get the latest
  1581.     version of GCC in source code, from the usual places
  1582.     (prep.ai.mit.edu or one of the many mirrored copies of it).
  1583.     Build and install that compiler using the Cygnus gcc binaries.
  1584.     Or get tech support from Cygnus; they produce a new version
  1585.     for their customers every three months, and will fix any
  1586.     bug you find.
  1587.  
  1588.     3) Gcc.
  1589.  
  1590.     Gcc is available from the GNU archives in source and binary
  1591.     form.  Look in a directory called sparc-sun-solaris2 for
  1592.     binaries.  You need gcc 2.3.3 or later.  You should not use
  1593.     GNU as or GNU ld.  Make sure you run just-fixinc if you use
  1594.     a binary distribution.  Better is to get a binary version and
  1595.     use that to bootstrap gcc from source.
  1596.  
  1597.     4) Info on Apogee, Lucid C, etc will be added if you send us some.
  1598.  
  1599. 6.2) What about the linker, the assembler and make?
  1600.  
  1601.     Solaris ships with everything you need, except for the compiler.
  1602.     All this stuff lives in /usr/ccs/bin and /usr/ccs/lib.
  1603.     If you still can't find it, make sure you have the following
  1604.     packages installed on your system:
  1605.  
  1606.         for tools (sccs, lex, yacc, make, nm, truss, ld, as):
  1607.         SUNWbtool, SUNWsprot, SUNWtoo
  1608.         for libraries & headers:
  1609.         SUNWhea, SUNWarc, SUNWlibm, SUNWlibms
  1610.         for ucb compat:
  1611.         SUNWsra, SUNWsrh
  1612.  
  1613. 6.3) What do I need to compile X11R5?
  1614.  
  1615.     There are several "patch kits" for X11R5 under Solaris 2.1.
  1616.     Most of them require gcc 2.3.3 and you must have
  1617.     run "fixincludes" when you install the gcc software.
  1618.  
  1619.     The recommended patchkit is R5.SunOS5.patch.tar.Z available
  1620.     from ftp.x.org:/contrib.  It works with gcc (2.3.3 or later)
  1621.     and SunPRO C.
  1622.  
  1623. 6.4) What happened to NIT? What new mechanisms exist for low-level network access?  
  1624.  
  1625.     See man page DLPI(7). Try NFSWATCH 4.0 for sample code using DLPI.
  1626.         FTP from harbor.ecn.purdue.edu (128.46.128.76, 128.46.154.76):
  1627.                 pub/davy/nfswatch4.0.tar.Z
  1628.         or gatekeeper.dec.com (16.1.0.2):
  1629.                 pub/net/ip/nfs/nfswatch4.0.tar.Z
  1630.  
  1631.     Better yet, FTP the paper "How to Use DLPI in Solaris 2.x" by
  1632.     Neal Nuckolls of Sun Internet Engineering.  Look in
  1633.     these FTP sites:
  1634.     opcom.sun.ca:/pub/drivers/dlpi/dlpi-spec.ps.gz
  1635.     opcom.sun.ca:/pub/drivers/dlpi/dltest.tar.gz
  1636.     opcom.sun.ca:/pub/drivers/dlpi/howtouseDLPI.ps.gz
  1637.  
  1638.     ftp.ui.org:/pub/osi/dlpi.ps
  1639.     ftp.ui.org:/pub/osi/npi.ps
  1640.     ftp.ui.org:/pub/osi/tpi.ps
  1641.  
  1642. 6.5) Where are all the functions gone that used to be in libc?
  1643.  
  1644.     The C library has exploded.  The manual page may give an
  1645.     indication where to find a specific function.
  1646.  
  1647.     Those libraries are essentially split over two directories:
  1648.  
  1649.         /usr/lib /usr/ccs/lib.
  1650.  
  1651.     Important libraries:
  1652.  
  1653.         /usr/lib:
  1654.         libsocket    - socket functions
  1655.         libnsl        - network services library
  1656.  
  1657.         /usr/ccs/lib:
  1658.         libgen        - regular expression functions
  1659.         libcurses    - the SysVR4 curses/terminfo library.
  1660.  
  1661.     See Intro(3) for more details.
  1662.  
  1663. 6.6) I'm still missing some functions: bcopy, bzero and friends.
  1664.  
  1665.     They are in /usr/ucblib/libucb.so.  The b* functions
  1666.     are replaced with the ANSI-C equivalents.  Look
  1667.     in the Solaris porting FAQ for more details.
  1668.  
  1669. 6.7) Can I use the source compatibility package to postpone porting?
  1670.  
  1671.     Not really.  The Source code compatibility package is
  1672.     compatible with BSD 4.2, not SunOS 4.1.x.  The consensus
  1673.     is that the library is broken beyond usability.
  1674.  
  1675. 6.8) Why doesn't readdir work?
  1676.  
  1677.     You're probably linking with libucb and didn't read the
  1678.     previous question.  (The readdir in libucb.so wants you to
  1679.     include sys/dir.h, many SunOS 4.1.x programs included
  1680.     <dirent.h>, consequently, you're mixing native <dirent.h>
  1681.     struct dirent with libucb readdir().
  1682.  
  1683. 7. ACKNOWLEDGEMENTS
  1684.     Most of this material is either written by me or sent to me
  1685.     directly. Some of it is cribbed shamelessly from USENET postings
  1686.     in several groups.
  1687.  
  1688.     Thanks to all people who contributed to this FAQ,
  1689.     you know who you are.  The list is too long to be included
  1690.     in this FAQ.
  1691.  
  1692. --- End of Solaris 2.x FAQ -- Maintained by Casper Dik <casper@fwi.uva.nl> ---
  1693.